package com.smdp.service;

import com.smdp.dto.Result;
import com.smdp.entity.BlogComments;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 博客评论服务接口。
 * 包含保存（新增）、回复、查询（根据博客id、根据父评论id）、删除博客评论的功能。
 *
 * @author 蔡方珩
 */
public interface IBlogCommentsService extends IService<BlogComments> {
    /**
     * 保存博客评论
     * @param blogComments 评论对象
     * @return 成功：评论id/失败：fail
     */
    Result saveComments(BlogComments blogComments);
    /**
     * 保存回复的评论。
     * 记录父评论id，以方便显示父评论和子评论关系。
     * @param blogComments 评论对象
     * @param answeredCommentsId 回复的评论id
     * @return 成功：评论id/失败：fail
     */
    Result replyComments(BlogComments blogComments, Long answeredCommentsId);
    /**
     * 根据博客id查询评论
     * @param current 当前页数
     * @param blogId 博客id
     * @return 成功：分页的博客评论
     */
    Result queryCommentsByBlogId(Integer current, Long blogId);
    /**
     * 根据父评论id查询子评论
     * @param current 当前页数
     * @param parentId 父评论id
     * @return 分页的子评论
     */
    Result querySonCommentsById(Integer current, Long parentId);
    /**
     * 根据id删除评论。
     * 拦截无权限的删除请求。
     * @param commentsId 评论id
     * @return 成功：评论id/失败：失败原因
     */
    Result deleteCommentsById(Long commentsId);
}
